home *** CD-ROM | disk | FTP | other *** search
/ MacSilverWare / macsilverware.iso / Control Panels / Greg's Buttons 3.11 / Greg's Buttons Docs < prev    next >
Text File  |  1993-08-22  |  19KB  |  350 lines
  1. ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  2. Greg's Buttons v3.1.1 (22 August 1993)    ©1991-93 Gregory D. Landweber
  3. REGISTRATION FEE: US $15 or UK £10        Internet: gdl1000@cus.cam.ac.uk
  4. ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  5.  
  6. Greg's Buttons is a control panel that lets you customize the user interface
  7. of a Macintosh running System 7™.  Greg's Buttons requires that your Mac
  8. support color, so it won't work on the Plus, SE, Classic, or PowerBook 100.
  9. It works fine with both color and gray-scale monitors, and although it will
  10. still work on a black and white screen, the effect won't be as impressive.
  11.  
  12. LIST OF FEATURES
  13. =================
  14. •    Replaces the standard flat black and white push buttons, check boxes, and
  15.     radio buttons with tasteful 3-D color ones.  These buttons are designed to
  16.     complement the windows and scroll bars in the System 7 interface, and in
  17.     particular they use the color tints that you can select in the "Color"
  18.     control panel.  You can choose from two styles of push buttons and three
  19.     styles each of radio buttons and check boxes.  There is also an option to
  20.     draw the text of push buttons using an "embossed" style.
  21.  
  22. •    Substitutes a font of your choice (chosen from Palatino and two versions
  23.     of Helvetica) for Chicago as your system font.  The system font is used in
  24.     menus, window titles, dialog boxes, and several other places throughout
  25.     the Mac interface.  Note that this feature does more than just changing
  26.     the menu font.  Also note that this feature has nothing to do with the
  27.     "Views" control panel, which changes the font in Finder™ windows.
  28.  
  29. •    Lets you select the background color of dialog boxes, menus (both the
  30.     text and background colors), and Finder™ windows.  Since the dialog box
  31.     colorization feature is known to cause some unavoidable aesthetic
  32.     conflicts, there is an "Exclude Applications…" button which lets you
  33.     specify applications in which the dialog boxes should not be colorized.
  34.  
  35. •    Colorizes the mini icons (the smallest size that you can select in the
  36.     "Views" control panel) in Finder™ list views (View by Name, Date, Size,
  37.     Kind, Label, Version, Comment, Favorite Melon, Astrological Sign, Sexual
  38.     Preference, etc.).
  39.  
  40. •    Colorizes the stop sign, caution, and note alert icons.
  41.  
  42. •    Changes to "Greg's Buttons" setting will take effect as soon as you close
  43.     the control panel.
  44.  
  45. CHANGES (since v3.1)
  46. ====================
  47. •    Fixed conflict with the Now Menus application substitution feature.
  48.  
  49. CHANGES (since v3.0)
  50. ====================
  51. •    The buttons now look much nicer in 4-bit grayscale (16 shades of gray).
  52. •    The "New Folder" button in some "Save as..." dialog boxes is now colored.
  53. •    Fixed the conflict with Now Compress.
  54. •    Fixed conflict with Spaceward Ho!.
  55. •    Fixed conflict with MasterJuggler.
  56.     Note that Greg's Buttons requires MasterJuggler v1.58 or higher.
  57. •    Fixed the conflict with Timbuktu.
  58. •    Fixed conflict with MacMoney that caused button titles to be garbled.
  59. •    Improved the appearance of push buttons in the ResEdit DLOG editor.
  60. •    The dialog box colorization feature is now more robust in its choice
  61.     of dialog boxes.  In particular, it will colorize movable modal dialog
  62.     boxes and the standard file boxes even when Dialog View is installed. 
  63. •    The exclusion list for the dialog box colorization feature now supports
  64.     desk accessories as well as applications, and the list has been put in
  65.     the prefs file (so you will not have to reconstruct it when you install
  66.     a future version of Greg's Buttons).
  67. •    The documentation file contains updated contact information.
  68.  
  69. WHAT PEOPLE ARE SAYING
  70. ========================
  71. "They don't look like buttons unless they're Greg's Buttons."
  72. "Apple should have included it in the Macintosh system software."
  73. "I can't imagine my Macintosh without Greg's Buttons."
  74.   — Shiny Happy Registered-Users Holding Mice
  75. "Without your [buttons] our success would not have been possible
  76.  during the past year." — Martin Marietta Energy Systems, Inc.
  77. "I won the MacTutor Programming Challenge" — My newest t-shirt
  78.  
  79. KNOWN PROBLEMS
  80. =================
  81. Greg's Buttons does some serious fiddling with the Macintosh user interface.
  82. While everything that Greg's Buttons does adheres to the various guidelines
  83. set up by Apple, applications often make invalid assumptions about their
  84. operating environment which no longer hold when you customize your Mac.
  85. Since the programmers did not forsee these changes, and since they never
  86. had the opportunity to test their products with Greg's Buttons,  there are
  87. bound to be some conflicts.  In most cases, these are not the fault of Greg's
  88. Buttons, but if I find out about them, I will try my best to work around such
  89. problems.  Here are some of the most common examples:
  90.  
  91. MasterJuggler
  92. -------------
  93. •  The "Substitute System Font" feature will not function properly with
  94.     MasterJuggler version 1.57c or earlier, but it should work fine with
  95.     version 1.58.  Contact ALSoft for an upgrade.
  96.  
  97. Directory Assistance II
  98. ----------------------
  99. •  I am told that Directory Assistance II prevents Greg's Buttons from
  100.     colorizing the "New Folder..." button in the "Save as..." dialog box.
  101.  
  102. theTypeBook
  103. ------------
  104. •  When Greg's Buttons is installed, theTypeBook will generate a font
  105.     error message, reporting "System Heap bit set: Font not loaded" for
  106.     the ".Cambridge" FOND.  This is nothing to be concerned about, and
  107.     you can disable theTypeBook's font error checking using its "Other
  108.     Options" dialog box (obtained by holding down the option key and
  109.     selecting the "File" menu).
  110.  
  111. MacWrite II
  112. -----------
  113. •  When the "Substitute System Font" feature is enabled, the "File", "Edit",
  114.     "Size", "Style", and "Format" menus in MacWrite II may freeze closed,
  115.     refuse to pull down when you click on them.   To fix this problem, switch
  116.     to one of the "(Chicago Spacing)" versions of the substitute system font.
  117.     This is a bug in the menu drawing routines in MacWrite II.
  118.  
  119. •  If the "Font" menu in MacWrite II freezes closed, you should remove the
  120.     "Claris Fonts" file in your system folder (possibly in a subfolder named
  121.     "Claris") to force MacWrite II to reconstruct its 'Font" menu the next
  122.     time you launch it.  This is also a bug in MacWrite II.
  123.  
  124. Canvas
  125. -------
  126. •  When the "Substitute System Font" feature is enabled, some of the menu
  127.     items in Canvas may be "blurred" when you drag the mouse over them.  To
  128.     fix this problem, either turn off the "Substitute System Font" feature or
  129.     selct the "Helvetica 12 (Chicago Spacing)" font.  This is a bug in Canvas.
  130.  
  131. Alarm Clock DA
  132. ---------------
  133. •  The Alarm Clock DA does not work properly with the "(Normal Spacing)"
  134.     substitute system fonts.  Use the "(Chicago Spacing)" fonts instead.
  135.  
  136. WriteNow
  137. ----------
  138. •  If you try to use the Balloon Help for the Greg's Buttons control panel
  139.     while WriteNow 3.0 is running, you may encounter spurious help balloons
  140.     flashing on and off while you drag the mouse over Greg's Buttons.  This
  141.     happens with any control panel, and it appears to be a bug in WriteNow.
  142.  
  143. Microsoft Graph
  144. ---------------
  145. •  The Microsoft Graph module seems to override the System 7 Color Buttons
  146.     feature.   As far as I can tell, MSGraph bypasses the standard button
  147.     drawing (and window dragging) routines in favor of its own, which look
  148.     and behave just like the standard ones.  It also uses non-standard
  149.     windows without a close box, and it akes over a strip at the bottom of
  150.     the screen for astatus bar.  Why can't Microsoft do things the Apple way
  151.     like everybody else?
  152.  
  153. Finder 7.1.1
  154. ------------
  155. •  The Finder mini-icon colorization feature will not work with Finder 7.1.1.
  156.     Nothing bad will happen; your mini-icons will revert to black and white.
  157.     If and when Finder 7.1.1 is actually released, I will release a new version
  158.     of Greg's Buttons fixing this problem.  All the rest of the features should
  159.     work with Finder 7.1.1 without requiring any modification.
  160.  
  161. COMMENTS, and FAQs (Frequently Asked Questions)
  162. ==============================================
  163. If Greg's Buttons causes problems on your Mac, try disabling its features
  164. one-by-one until the problem goes away.  Most likely, the problem is caused
  165. by only one of the many features, and the rest of the features will work
  166. fine for you.  In particular, any problem relating to dialog boxes is probably
  167. caused by the dialog box colorization feature, while a problem involving
  168. menus is most likely due to either the substitute system font or the menu
  169. colorization feature.  The buttons themselves are exremely stable.
  170.  
  171. "Substitute System Font" Feature
  172. -------------------------------
  173. •  Several programs, such as Canvas, MacWrite II, and the Alarm Clock DA
  174.     do not bother to check the system font spacing, assuming the spacing for
  175.     Chicago.  As a result, they do not work properly with the "Normal Spacing"
  176.     versions of the substitute system fonts.  In order to maintain
  177.     compatibility with such programs, I have included a "Chicago Spacing"
  178.     version which uses spacing similar to Chicago.  You may notice, however,
  179.     that the numbers will appear oddly spaced in this version of the font.
  180.  
  181. •  No, it is not possible to substitute an arbitrary font for the system font.
  182.     The font has to be tweaked rather significantly in order for it to work
  183.     reliably.  If you have a pet font that you'd like to see added to the list of
  184.     alternate system fonts in Greg's Buttons, let me know via e-mail.
  185.  
  186. •  When you switch system fonts, the menus may not adjust to the new font
  187.     spacing immediately.  This will be fixed when the menu bar is redrawn.
  188.  
  189. •  Note that thin fonts, such as "Helvetica 12" and "Palatino 12" will be
  190.     illegible when dimmed or grayed-out on a black and white monitor.
  191.  
  192. "Alerts and Dialog Boxes" Background Color Feature
  193. -----------------------------------------------
  194. •  Some applications assume that they are dealing with a black and white
  195.     dialog box while Greg's Buttons substitutes a color one.  The difference is
  196.     enough to cause some odd behavior.  There is no way to fix such conflicts
  197.     without rewriting parts of the offending applications.  However, you can
  198.     specify applications to be excluded from this feature by clicking the 
  199.     "Exclude Applications..." button and adding the application to the exclusion
  200.     list.  The list includes Microsoft Word, Canvas, Help!, and Disk First Aid.
  201.  
  202. •  For some choices of the dialog box background color, the text insertion
  203.     cursor may be drawn in a just barely visible color.  This is the result of
  204.     the brain-dead routines the Mac uses to figure out a "suitable" inverse
  205.     (it thinks light yellow shows up well against a light gray, for instance).
  206.     To get around this, try changing the dialog box background color very
  207.     slightly, and the inverse routine may arbitrarily pick a better color.
  208.  
  209. •  When dialog colorization is turned on, you may notice that alert boxes
  210.     (the kind with the stop sign, caution, or note icon in the top-left corner)
  211.     are drawn with a grayed-out border.  This is a documented bug in the
  212.     system software, and Apple intends to fix it in a future release.
  213.  
  214. "Menu Bar and Menus" Color Feature
  215. --------------------------------
  216. •  If you have used another control panel (such as "Aurora" or "Kolor 2.0") to
  217.     color your menu bar, your previous menu color settings will override the
  218.     settings in the Greg's Buttons control panel.  If you want to use the menu
  219.     colorization feature in Greg's Buttons instead, use the other control panel
  220.     to set the menu colors back to black and white.  Greg's Buttons will then
  221.     remove the color information from the system file and substitute its own.
  222.  
  223. •  If your monitor is in 16-bit mode (thousands of colors) and you colorize
  224.     your menus, you may encounter gibberish in the menu bar when you launch
  225.     an application.  This is not a bug in Greg's Buttons (or Aurora or Kolor for
  226.     that matter), but rather a bug in the system software.
  227.  
  228. "Finder Window Color" Feature
  229. ----------------------------
  230. •  When you quit from an application that modifies the system color palette,
  231.     some Finder windows may be left with sploches of random colors in them.
  232.     This will go away as soon as the offending windows are re-drawn.  There
  233.     is nothing that I can do about this problem.  The Finder is ultimately 
  234.     responsible for updating its windows; I just tell it what color to use.
  235.  
  236. "System 7 Color Buttons" Feature
  237. -------------------------------
  238. •  The third radio button dot style uses the highlight color that you can
  239.     select in the "Color" control panel.
  240.  
  241. •  Occasionally, you may find that push button titles are "fuzzy", "blocky"
  242.     or "blurred".  This has been known to happen in Word, the HP DeskWriter
  243.     dialog box and Alias Director.  This problem will go away if you turn
  244.     off the "Embossed Push Button Text".
  245.  
  246. Customing Greg's Buttons using ResEdit
  247. -------------------------------------
  248. •  If you don't know what a CICN is, then I won't tell you, but if you do know
  249.     and have ResEdit, then you can design your own radio buttons and check
  250.     boxes.  To add the color tinges, you use the corresponding SICN resources.
  251.     The first SICN in each 2-SICN list gives the pixels that are drawn with
  252.     the dark tinge.  The second SICN in the list (the mask) gives all the pixels
  253.     that are drawn with either the light or dark tinge.  So, the pixels drawn
  254.     with the light tinge are those in the mask but not in the first SICN.
  255.     If you do not want any color tinges, just delete the SICN.
  256.  
  257. •  Do not use ResEdit on the active Greg's Buttons file!  In addition to the
  258.     standard warnings, this could crash your Mac.  Make a copy first, and use
  259.     ResEdit on that copy.  After you have made your changes, drag the original
  260.     file out of the system folder, put the copy in its place, and restart.
  261.  
  262. •  Resources in the System file will override those in the Greg's Buttons
  263.     file with the same ID number.  If you want your ResEdit modifications to
  264.     last between versions of Greg's Buttons, install them in your System file.
  265.     This way, you won't have to reinstall these resources every time you get
  266.     a new version of Greg's Buttons.
  267.  
  268. REGISTRATION
  269. ==============
  270. "Greg's Buttons" is SHAREWARE.  You may try it out for ten days. If after
  271. that time, you think it is a frivolous waste of processor time and disk
  272. space, just take a good look at your Mac without Greg's Buttons.  It will
  273. look dull, Dull, DULL!  If you want to keep it, you should register as follows:
  274.  
  275. Shareware Fees
  276. ---------------
  277. •  Single Machine License  —  US$15   / UK£10
  278. •  2 - 14 Machine License  —  US$10   / UK£6     per machine
  279. •  Unlimited Site License  —  US$150 / UK£100
  280.  
  281. Methods of Payment
  282. -------------------
  283. •  US Dollars, either by check (drawn on a US bank), postal money order, or
  284.     cash sent to my home address in the USA:
  285.         Gregory D. Landweber
  286.         10 Wallingford Drive
  287.         Princeton, NJ  08540
  288.  
  289. •  UK Pounds Sterling, either by cheque (drawn on a UK bank), EuroCheque,
  290.     or cash sent to one of the following addresses in ENGLAND (note the dates):
  291.         Until 20 September 1993:
  292.             G. D. Landweber, Trinity College, Cambridge  CB2 1TQ
  293.         From 20 September 1993 to 31 July 1994:
  294.             G. D. Landweber, New College, Oxford  OX1 3BN 
  295.  
  296. •  Please do not send any currencies other than US$ or UK£.
  297.  
  298. Please make the check payable to me, "Gregory D. Landweber", NOT to
  299. "Greg's Buttons".  With your payment include me your e-mail address
  300. (preferably internet), the version number, and where you got your copy.
  301.  
  302. If you have an account on CompuServe, you can use the online shareware
  303. registration service.  Just type "GO SWREG" and follow the instructions.
  304.  
  305. After Registering
  306. -----------------
  307. •  There are no passwords, enabling codes, or registration numbers.  Once
  308.     you have registered, you are entitled to feel good about yourself and to
  309.     turn off the "Annoying Shareware Message" check box.  You will NOT get
  310.     any feedback from me to acknowledge receipt of your shareware payment.
  311.     Please do not worry whether I got your money.  If you sent a check, you'll
  312.     find out from your bank, and if you sent cash, well, it's the thought that
  313.     counts, isn't it!  Having paid once, you will never have to pay me anything
  314.     again, even if I add zillions of features and raise the shareware fee.
  315.  
  316. •  If you obtained this version from an online service, BBS, or User's Group,
  317.     then you should be able to obtain any and all new releases from the same
  318.     souce.  If you got this version from a CD-ROM or bundled with a book, and
  319.     if you have no other way of acquiring the latest update, send me a politely
  320.     worded letter explaining your predicament.  If the version you are using is
  321.     sufficiently out-of-date, I will eventually send you the most recent one.
  322.     Please do NOT mail me floppy disks or extra money and then complain that
  323.     I do not reply.  I'm a mathematician, not a commercial software publisher.
  324.  
  325. •  I will gladly e-mail a binhex'd copy of the latest version of Greg's Buttons
  326.     to anyone who e-mails me a request.  I can only send the file to addresses
  327.     on CompuServe or the Internet.  The file is too large to cross the gateway
  328.     to America Online or AppleLink.  Sorry.
  329.  
  330. DISTRIBUTION
  331. ==============
  332. This software is NOT in the public domain; rather it is Copyright ©1993 by
  333. Gregory D. Landweber (with parts Copyright ©1993 Symantec Corporation
  334. since it was written in Think C 6.0).  You may freely copy and distribute
  335. this software, provided that it you do not charge for it.  This software MAY
  336. be included in any disk or CD-ROM library of public domain and shareware
  337. software sold by a NON-PROFIT organization.  This software MAY NOT be
  338. included in any commercial software collection sold for profit, nor may it
  339. be bundled with any commercial software, hardware, books, or other media
  340. without the prior written consent of the author.  Whenever it is distributed,
  341. the "Greg's Buttons" control panel must be accompanied by this
  342. documentation file IN FULL.
  343.  
  344. DISCLAIMER
  345. ============
  346. The author, Gregory D. Landweber, makes no warranties, either express or
  347. implied, regarding the fitness of the "Greg's Buttons" control panel for any
  348. particular purpose.  Use the "Greg's Buttons" control panel at your own risk.
  349. The author claims no liability for data loss or any other problems caused
  350. directly or indirectly by the "Greg's Buttons" control panel.